home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Special 4 / Amiga Plus Sonderheft 1996 #4.iso / cando-vollversion / helpfiles / variablen ii  < prev    next >
Text File  |  1992-10-23  |  11KB  |  493 lines
  1. F- Alias                |alias|
  2. F- BumpRevision            |bumprevision|
  3. F- Case                    |case|
  4. F- CharsToHex            |charstohex|
  5. C- DeleteArrayEntry        |deletearrayentry|
  6. F- Evaluate                |evaluate|
  7. F- EvaluateExpression    |evaluateexpression|
  8. F- FirstArrayIndex        |firstarrayindex|
  9. F- FormatValue            |formatvalue|
  10. V- GetDBObjects            |getdbobjects|
  11. C- Global                |global|
  12. F- HexToChars            |hextochars|
  13. F- HexToInteger            |hextointeger|
  14. V- Infinity                |infinity|
  15. F- IntegerToHex            |integertohex|
  16. F- IfThen                |ifthen|
  17. F- Input                |input|
  18. C- InsertArrayEntry        |insertarrayentry|
  19. C- InsertRecordNames    |insertrecordnames|
  20. F- IsAlias                |isalias|
  21. F- LastArrayIndex        |lastarrayindex|
  22. F- Limit                |limit|
  23. F- LoadVariable            |loadvariable|
  24. C- Local                |local|
  25. F- Match                |match|
  26. F- NextArrayIndex        |nextarrayindex|
  27. V- NotANumber            |notanumber|
  28. F- NumberOfArrayEntries    |numberofarrayentries|
  29. F- PreviousArrayIndex    |previousarrayindex|
  30. C- SaveVariable            |savevariable|
  31. F- SearchArray            |searcharray|
  32. C- SetDBObjects            |setdbobjects|
  33. C- SetSearchArrayFlags    |setsearcharrayflags|
  34. C- SortArray            |sortarray|
  35. C- Static                |static|
  36. F- ValidReal            |validreal|
  37. F- VarType                |vartype|
  38. F- VerifyExpression        |verifyexpression|
  39. [E]
  40.  
  41. |alias|
  42. WT <Variable>=Alias({String})
  43. PL Definiert die Variable als Alias für den,
  44. PL aus dem {String} erzeugten Variablennamen.
  45. PL Im Handbuch finden Sie eine genaue Funk-
  46. PL tionsbeschreibung.
  47. PL 
  48. PT Siehe auch: 
  49. BS IsAlias
  50. ED
  51.  
  52. |bumprevision|
  53. WT {String}=BumpRevision({String})
  54. PL Erhöht die Versionsnummer des Strings in der
  55. PL selben Weise, wie die Diskcopy Funktion der
  56. PL Workbench.  Im Handbuch finden Sie eine
  57. PL genaue Funktionsbeschreibung.
  58. ED
  59.  
  60. |case|
  61. WT {Ergebnis}=Case({Ganzzahl n}, {Ausdruck1} [,bis zu 10 Ausdrücke] )
  62. PL Gibt des Ergebnis der Berechnung des n-ten
  63. PL Ausdrucks zurück. Zum Beispiel:
  64. PL  <- Let X = 2
  65. PL  <- Echo Case(X,"Gold","Silber","Bronze")
  66. PL  -> Silber
  67. PT Siehe auch: 
  68. BS IfThen
  69. PT   
  70. BS Match
  71. ED
  72.  
  73. |charstohex|
  74. WT {HexString}=CharsToHex({String})
  75. PL Wandelt einen normalen String in einen dop-
  76. PL pelt so langen Hex-String.
  77. PL  <- Echo CharsToHex("CanDo 2.0")
  78. PL  -> 43616E446F2056322E30
  79. PL
  80. PT Siehe auch: 
  81. BS HexToChars
  82. PT   
  83. BS FileWriteChars
  84. ED
  85.  
  86. |deletearrayentry|
  87. WT DeleteArrayEntry <ArrayVar>, {ArrayIndex}
  88. PL Löscht den Array-Eintrag mit dem angegebenen
  89. PL Index aus dem Array.  Alle darüberliegenden
  90. PL Einträge werden, beginnend mit {ArrayIndex},
  91. PL neu durchnummeriert.
  92. PL
  93. PT Siehe auch: 
  94. BS InsertArrayEntry
  95. PT   
  96. BS Dispose
  97. ED
  98.  
  99. |evaluate|
  100. WT {Ergebnis}=Evaluate({Ausdruck})
  101. PT Siehe: 
  102. BS EvaluateExpression
  103. ED
  104.  
  105. |evaluateexpression|
  106. WT {Ergebnis}=EvaluateExpression({Ausdruck})
  107. PL Wenn der String einen gültigen Ausdruck ent-
  108. PL hält, so wird das Ergebnis dessen Berechnung
  109. PL zurückgegeben. Ist der Ausdruck ungültig, so
  110. PL erzeugt CanDo einen Fehler. Benutzen Sie 
  111. BS VerifyExpression
  112. PL  um dieses Problem auszu-
  113. PL schalten.
  114. ED
  115.  
  116. |firstarrayindex|
  117. WT {ArrayIndex}=FirstArrayIndex(<ArrayVar>)
  118. PL Gibt den kleinsten in diesem Array existie-
  119. PL renden Index zurück.  Wenn das Array keine
  120. PL Einträge besitzt, wird der Wert 0 zurückge-
  121. PT geben und 
  122. BS SearchFound
  123. PT  auf 
  124. BS False
  125. PL  gesetzt.
  126. PL
  127. PT Siehe auch: 
  128. BS LastArrayIndex
  129. ED
  130.  
  131. |formatvalue|
  132. WT {String}=FormatValue({Wert}, {FormatString})
  133. PL Formatiert den angegebenen Zahlenwert ent-
  134. PL sprechend der Definition, die durch den
  135. PL {FormatString} vorgegeben wird. Im Handbuch
  136. PL finden Sie die genaue Funktionsbeschreibung.
  137. ED
  138.  
  139. |getdbobjects|
  140. WT {RecordVar}=GetDBObjects
  141. PL Gibt eine Record-Variable zurück, die die
  142. PL Inhalte aller aktuell auf der Card befind-
  143. PL lichen Datenbank-Objekte enthält. Genaue 
  144. PL Funktionsbeschreibung siehe Handbuch.
  145. PL 
  146. PT Siehe auch: 
  147. BS SetDBObjects
  148. ED
  149.  
  150. |global|
  151. WT Global <VarName>
  152. PT Alle Variablen die nicht mittels 
  153. BS Local
  154. PL  oder
  155. BS Static
  156. PL  definiert wurden, sind global.
  157. PL Dieser Befehl wurde nur der Vollständigkeit
  158. PL halber implementiert.
  159. ED
  160.  
  161. |hextochars|
  162. WT {String}=HexToChars({HexString})
  163. PL Der angegebene Hex-String wird in einen nor-
  164. PL malen String gewandelt. Ein Hex-String wird
  165. PT zum Beispiel vom Befehl 
  166. BS FileReadChars
  167. PL  zu-
  168. PL rückgegeben.
  169. PL
  170. PT Siehe auch: 
  171. BS CharsToHex
  172. ED
  173.  
  174. |hextointeger|
  175. WT {Ganzzahl}=HexToInteger({HexString})
  176. PL Der angegebene Hex-String wird in eine
  177. PL Ganzzahl gewandelt. Ein Hex-String wird zum
  178. PT Beispiel vom Befehl 
  179. BS FileReadChars
  180. PL  zurück-
  181. PL gegeben.
  182. PL
  183. PT Siehe auch: 
  184. BS IntegerToHex
  185. ED
  186.  
  187. |infinity|
  188. WT {Realzahl}=Infinity
  189. PL Gibt den IEEE-Fließkommawert für Unendlich
  190. PL zurück.  Im Handbuch finden Sie eine genaue
  191. PL Beschreibung dieser System Variablen.
  192. PL
  193. PT Siehe auch: 
  194. BS NotANumber
  195. PT   
  196. BS ValidReal
  197. ED
  198.  
  199. |ifthen|
  200. WT {Ergebnis}=IfThen({Boolscher Wert}, {TrueAusdruck} [,{FalseAusdruck}])
  201. PL Gibt den {TrueAusdruck} zurück wenn der
  202. PT {Boolsche Wert} 
  203. BS True
  204. PL  ist. Sonst wird der
  205. PL {FalseAusdruck} oder, falls dieser nicht
  206. PT angegeben wurde, 
  207. BS Nothing
  208. PL  zurückgegeben.
  209. PL
  210. PT Siehe auch: 
  211. BS Match
  212. PT   
  213. BS Case
  214. ED
  215.  
  216. |input|
  217. WT {String}=Input({Prompt})
  218. PL Zeigt den "Prompt" im CLI an, um eine Einga-
  219. PL bezeile vom Benutzer zu erfragen. Es muß ein
  220. PL CLI geöffnet sein, um mit dieser Funktion zu
  221. PL arbeiten.  Die Eingabe wird mit der Return-
  222. PL Taste abgeschlossen.
  223. ED
  224.  
  225. |insertarrayentry|
  226. WT InsertArrayEntry <ArrayVar>, {ArrayIndex}
  227. PL Erzeugt Platz für einen neuen Eintrag mit
  228. PL dem angegebenen Index im Array. Alle darü-
  229. PL berliegenden Einträge werden beginnend mit
  230. PL {ArrayIndex}+1 neu durchnummeriert.
  231. PL 
  232. PT Siehe auch: 
  233. BS DeleteArrayEntry
  234. ED
  235.  
  236. |insertrecordnames|
  237. WT InsertRecordNames <RecordVar>
  238. PL Schreibt die Namen aller Einträge in der
  239. PL angegebenen Record-Variablen ins aktuelle
  240. PL Dokument. Dieser Befehl kann verwendet
  241. PL werden, um die Namen von unbekannten
  242. PL Einträgen zu ermitteln.
  243. ED
  244.  
  245. |integertohex|
  246. WT {HexString}=IntegerToHex({Ganzzahl})
  247. PL Wandelt die {Ganzzahl} in einen Hex-String.
  248. PL Dieser String kann zwei, vier, sechs oder
  249. PL acht Zeichen lang sein.
  250. PL  <- Echo IntegerToHex(1256)
  251. PL  -> 04E8
  252. PT Siehe auch: 
  253. BS HexToInteger
  254. PT   
  255. BS CharsToHex
  256. ED
  257.  
  258. |isalias|
  259. WT {Boolscher Wert}=IsAlias(<VarName>)
  260. PT Gibt den Wert 
  261. BS True
  262. PL  zurück, wenn die angege-
  263. PL bene Variable ein Alias ist.
  264. PL
  265. PT Siehe auch: 
  266. BS Alias
  267. ED
  268.  
  269. |lastarrayindex|
  270. WT {ArrayIndex}=LastArrayIndex(<ArrayVar>)
  271. PL Gibt den größten in diesem Array existieren-
  272. PL den Index zurück. Wenn das Array keine Ein-
  273. PL träge besitzt, wird der Wert 0 zurückgegeben
  274. PT und 
  275. BS SearchFound
  276. PT  auf 
  277. BS False
  278. PL  gesetzt.
  279. PL
  280. PT Siehe auch: 
  281. BS FirstArrayIndex
  282. ED
  283.  
  284. |limit|
  285. WT {Ganzzahl}=Limit({MinGrenze}, {MaxGrenze}, {Ganzzahl})
  286. PL Gibt die {Ganzzahl} zurück, wenn diese zwi-
  287. PL schen den Zahlen {MinGrenze} und {MaxGrenze}
  288. PL liegt. Ist sie größer als beide Grenzen, so
  289. PL wird die größere der beiden Grenzen zurück-
  290. PL gegeben; Ist sie kleiner als beide Grenzen,
  291. PL wird die kleinere Grenze zurückgegeben.
  292. ED
  293.  
  294. |loadvariable|
  295. WT {Variable}=LoadVariable({DateiPfad})
  296. PL Gibt den Inhalt der gespeicherten Variablen
  297. PL zurück.
  298. PL 
  299. PT Siehe auch: 
  300. BS SaveVariable
  301. ED
  302.  
  303. |local|
  304. WT Local <VarName>
  305. PL Der Befehl definiert, daß die Variable nur
  306. PL von dem aktuellen Script aus benutzt werden
  307. PL kann und nach dessen Ausführung gelöscht
  308. PL wird.
  309. PL
  310. PT Siehe auch: 
  311. BS Static
  312. PT   
  313. BS Global
  314. ED
  315.  
  316. |match|
  317. WT {Ganzzahl}=Match({Ganzzahl oder String}, {TestDaten1} [,bis zu 10 TestDaten])
  318. PL Gibt die Nummer der Testdaten zurück, die
  319. PL mit der Ganzzahl bzw. dem String überein-
  320. PL stimmen, oder 0 falls keine überstimmen.
  321. PL Genaue Beschreibung siehe Handbuch.
  322. PL
  323. PT Siehe auch: 
  324. BS Case
  325. PT   
  326. BS IfThen
  327. ED
  328.  
  329. |nextarrayindex|
  330. WT {ArrayIndex}=NextArrayIndex(<ArrayVar>, {ArrayIndex})
  331. PL Gibt den nächstgrößeren, im Array existie-
  332. PL renden Index nach {ArrayIndex} an. Existiert
  333. PL kein größerer Index, so wird der übergebene
  334. PL {ArrayIndex} zurückgegeben und die Systemva-
  335. PT riable 
  336. BS SearchFound
  337. PT  auf 
  338. BS False
  339. PL  gesetzt.
  340. PT Siehe auch: 
  341. BS PreviousArrayIndex
  342. ED
  343.  
  344. |notanumber|
  345. WT {Realzahl}=NotANumber
  346. PL Dieser Wert entspricht dem Ergebnis einiger
  347. PL Fließkomma-Berechnungen, die kein numeri-
  348. PL sches Ergebnis liefern. Genaue Beschreibung
  349. PL dieser Konstanten siehe Handbuch.
  350. PL
  351. PT Siehe auch: 
  352. BS Infinity
  353. PT   
  354. BS ValidReal
  355. ED
  356.  
  357. |numberofarrayentries|
  358. WT {Ganzzahl}=NumberOfArrayEntries(<ArrayVar>)
  359. PL Gibt die Anzahl der Einträge im angegebe-
  360. PL nen Array zurück.
  361. ED
  362.  
  363. |previousarrayindex|
  364. WT {Ganzzahl}=PreviousArrayIndex(<ArrayVar>, {ArrayIndex})
  365. PL Gibt den nächstkleineren, im Array existie-
  366. PL renden Index vor {ArrayIndex} an. Existiert
  367. PL kein kleinerer Index, so wird der übergebene
  368. PL {ArrayIndex} zurückgegeben und die Systemva-
  369. PT riable 
  370. BS SearchFound
  371. PT  auf 
  372. BS False
  373. PL  gesetzt.
  374. PT Siehe auch: 
  375. BS NextArrayIndex
  376. ED
  377.  
  378. |savevariable|
  379. WT SaveVariable <VarName>, {DateiPfad}
  380. PL Speichert den Inhalt der Variablen unter dem
  381. PL angegebenen Pfad ab.  Wenn die Variable ein
  382. PL Array oder Record ist, so wird der gesamte
  383. PL Datensatz abgespeichert.
  384. PL 
  385. PT Siehe auch: 
  386. BS LoadVariable
  387. ED
  388.  
  389. |searcharray|
  390. WT {ArrayIndex}=SearchArray(<ArrayVar>, {SuchDaten} [,{SchlüsselString} [,{StartIndex}]])
  391. PL Sucht die angegebenen Daten im Array. Mit
  392. PL dem {SchlüsselString} kann die Suche auf
  393. PL einen Record-Eintrag oder ein Sub-Array
  394. PL beschränkt werden.
  395. PL
  396. PT Siehe auch: 
  397. BS SetSearchArrayFlags
  398. PT  
  399. BS SearchFound
  400. ED
  401.  
  402. |setdbobjects|
  403. WT SetDBObjects <RecordVar>
  404. PL Setzt alle Datenbank-Objekte der aktuellen
  405. PL Card auf die Werte der gleichnamigen Ein-
  406. PL träge im angegeben Record.
  407. PL 
  408. PT Siehe auch: 
  409. BS GetDBObjects
  410. ED
  411.  
  412. |setsearcharrayflags|
  413. WT SetSearchArrayFlags <Flags>
  414. PL Setzt die Suchflags für die Funktion
  415. BS SearchArray
  416. PL . Im Handbuch finden Sie eine
  417. PL genaue Beschreibung der Flags.
  418. PL
  419. PL                ...Flags siehe nächste Seite
  420. NP setsearcharrayflags2
  421. ED
  422.  
  423. |setsearcharrayflags2|
  424. WT SetSearchArrayFlags <Flags>
  425. PL Flags:
  426. PL                   FORWARD, BACKWARD, NOCASE
  427. PL                      SUBSTRING, SUPERSTRING
  428. PP setsearcharrayflags
  429. ED
  430.  
  431. |sortarray|
  432. WT SortArray <ArrayVar>, <Flags> [,{SchlüsselString}]
  433. PL Sortiert die Einträge im angegebenen Array.
  434. PL Genaue Funktionsbeschreibung siehe Hand-
  435. PL buch.
  436. ED
  437.  
  438. |static|
  439. WT Static <VarName>
  440. PT Entspricht dem Befehl 
  441. BS Local
  442. PL  mit dem Unter-
  443. PL schied, daß die Variablen beim nächsten
  444. PL Aufruf des Scripts noch die alten Werte
  445. PL enthalten.
  446. PL
  447. PT Siehe auch: 
  448. BS Global
  449. ED
  450.  
  451. |validreal|
  452. WT {Boolscher Wert}=ValidReal({Realzahl})
  453. PT Gibt 
  454. BS True
  455. PL  zurück, falls es sich bei der an-
  456. PL gegebenen Realzahl um eine existierende,
  457. PL nicht unendliche Zahl handelt. Genaue Funk-
  458. PL tionsbeschreibung siehe Handbuch.
  459. PL 
  460. PT Siehe auch: 
  461. BS NotANumber
  462. PT   
  463. BS Infinity
  464. ED
  465.  
  466. |vartype|
  467. WT {String}=VarType(<VarName>)
  468. PL Gibt den Typ der Variablen zurück:
  469. PL                      String, Integer, Real,
  470. PL     Logical, Nothing, System, Array, Record
  471. PL
  472. BS Alias
  473. PL  Variablen können nur mit Hilfe der
  474. PT der Funktion 
  475. BS IsAlias
  476. PL  erkannt werden.
  477. ED
  478.  
  479. |verifyexpression|
  480. WT {Boolscher Wert}=VerifyExpression({Ausdruck})
  481. PT Gibt 
  482. BS True
  483. PL  zurück wenn der {Ausdruck} gültig
  484. PT ist, sonst 
  485. BS False
  486. PL .
  487. PL 
  488. PL Der Befehl wird meist vor der Funktion
  489. BS EvaluateExpression
  490. PL  benutzt, um Fehler zu
  491. PL vermeiden.
  492. ED
  493.